Video Genie and TRS-80 Level 2 



SRCH. (Size 128 bytes). 



SRCH enables you to search a BASIC program for 
string may include special characters, e.g. A=8, 
characters . 



any specified character string, up to 16 bytes long. The 
or keywords, e.g. PRINTA, Blanks count as significant 



Load SRCH, following the instructions on the separate sheet entitled RELOC, and relocate it to a suitable 
address in protected memory. Invoke it either by calling USR with a dummy argument, or via the SYSTEM command, 
branching to its start address by /n, where n is the address at which SRCH is located. Once invoked, SRCH waits 
for input, which can be any string up to a maximum of 16 characters. SRCH displays all the line numbers in the 
current BASIC program, in which that string appears, and then waits for more input. To terminate, hit ENTER 
alone (Video Genie NEWLINE) . 

SRCH correctly interprets BASIC keywords as single-byte elements, which is how they are stored in the 
program by the editor. This means, for example, that the string SUM will not be found in RESUME, since RESUME is 
a keyword. But the editor stores the characters inside quotes or after REMarks literally, i.e. not translated to 
code-bytes, so SUM will be found in 'NOW RESUME SCAN, or in PRINT "TYPE STOP OR RESUME". Also, many special 
symbols, =, +, -, etc., are represented differently in the body of the program from in quotes or remarks. SRCH 
assures you are looking for the string as part of the program, not as a literal. 

Get into the habit of using SRCH whenever you modify a working BASIC program, Before you invent a new 
variable name, make sure the name has not already been used. If you delete a line, rake sure there are no 
dangling references to that line number. Before changing a section of code, check for all paths into that 
section, via GOTOs or GOSUBs. 

SRCH does not occupy such memory, so you can probably afford to keep it resident at all times. If you dont 
want to assign a permanent USR allocation to its entry point, then either use the branch entry to invoke it, or 
get the Southern Software utility USRN which allows you to assign multiple entry points to USR, using the 
argument as a selector. 
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Video Genie and TRS-80 Level 2. RELOC 



How to Load and Relocate a Southern Software Machine-Language Program. 



You choose the location of the program in memory, to suit your machine size. This MUST be in protected 
memory, or the program will not run. So, taking account of your machine size, allow enough space for the program 
itself, plus any other machine-language subroutines you may need, either above or below the program you are 
loading. 

As an example, suppose you are loading Southern Software DLOAD (size 160 bytes) . You have already loaded, 
or are going to load, TRS KBFIX at the top of memory, and Southern Software TSAVE below DLOAD. Plan your memory 
use as follows, working out the values (T) and (A) for your situation: 





PROG SIZE 




MACHINE 


SIZE 






(bytes) 


4K 


16K 


32K 


48K 


Memory limit 




20480 


32768 


49152 


65536 


Space for KBFIX 


56 


20424 


32712 


49096 


65480 


Space for DLOAD 


160 


20264 


32552 


48936 


65320 (T) 


Space for TSAVE 


512 


19752 


32040 


48429 


64808 (A) 



l)Turn on the computer. If you have a DISK system, enter Level2, not DISK BASIC. 

2) answer the MEMORY SIZE question with your value of (A) . (On Video Genie, this value is used after READY?) 

3) prepare the cassette player to load the self-relocating program. 



4) 
5) 
6) 
7) 
8) 



After tape has loaded 



TRS-80 


You type: 


> 


SYSTEM (enter) 


*? 


DLOAD (enter) or your program name 


*? 


/ (enter) 


TARGET ADDR? 


Your value of (T) 


READY 





Notes : 

l)At step 5 the tape will load and a pair of asterisks will blink on the display. If there are no asterisks, or 
two unblinking asterisks, or C*, then there has been a loading error. Stop the recorder, reset, and retry with a 
new volume setting. 

2)At step 7, the program will relocate itself to address T. If instead of typing a value you just hit enter, 
then the program will relate itself to A, the answer to the MEMORY SIZE question. 

3)Under Level2, after relocation, the program is ready to be invoked with a USR(n) call, since the USR address 
is automatically primed. However this does not work under DISK BASIC (or Level3) , and you must additionally set 
DEFUSRn to inform the system of this routine's address. 

4) Once a program has been loaded and relocated, it can be dumped to a new tape using Southern Software TSAVE, or 
TRS TBUG. Then it will load directly to its final location. Use of TSAVE has the advantage that several programs 
can be dumped on a single file, which can also preprime the USR address. 

5)During step 5, the program is temporarily load into locations 18944 and up. This means that 

a) You must perform all necessary relocating loads before loading a BASIC program, or entering DISK BASIC. 
b)The final location, T, of the self-relocating program can never be lower than 18960. (Hex 4A10) . 

6) If you run under DISK BASIC, then perform the initial self-relocating load under Level2, as described. Then 
reenter TRSDOS (or NEWDOS, etc) and use the DUMP command to save the core image directly from its relocated 
position. Subsequently you can LOAD the core image directly, under TRSDOS. But when you enter DISK BASIC, 
remember to set MEMORY SIZE to leave this area of core protected, and remember that the top 64 bytes of memory 
are corrupted by the DISK BASIC loader, and should not be used for programs. 




wiiiiiiniiiimmmirffiiHiiiiiiiiiiiiiiiiiiih 



'software, 




PO Box 39, Eastteigh, Hants, England. S055WQ 



Video Genie and TRS-80 Level 2. HINTS 



Hints on Tape Loading. 



1) Listen to the tape to establish exactly where the data starts. Note this on the tape label. 

2) Turn the volume down to zero, and "attempt" a tape load, very slowly increasing the volume until you get 
asterisks on the screen. Stop the tape (not the computer), note the volume level, Reboot. 

3) Turn the volume up to maximum, and "attempt" a tape load, very slowly decreasing the volume until you get 
asterisks on the screen. Again, stop the tape, and note the vole, 

4) Set the volume to slightly above the mid-point of the two extremes of volume, and attempt a real load. 

Possible Tape or Recorder Faults. 

1) Kink or fold in the tape. Even a minor fold may render the tape unloadable, (Southern Software tapes carry a 
second copy of the file, in case the first gets damaged) . 

2) Noise caused by RESET when tape is running, Always stop the tape before hitting RESET. 

3) Being small, all the plugs are prone to intermittent error and should be protected against movement. 

4) Inconsistent tracking of the tape over the head. 

This list does not include poor tape quality, since it is very unlikely to be a problem, at the frequency 
bits are recorded. However, you may have found that one make of cassette seems much better than another. This is 
probably due to the construction of the cassette, rather than the tape. Generally more expensive cassettes run 
more smoothly, and therefore reduce the chance of poor tracking of tape over the head. 

How DATA is Recorded and Read. 



The computer contains hardware to generate an "above-and-below-zero" pulse, as shown below. This is fired 
by direct program control. The output routine produces one such clock pulse every 500th of a second (by 
looping) . Data ones and zeroes are recorded as pulses halfway between these clock signals, A zero is the absence 
of a pulse, a one is the presence of a pulse. 



The playback logic is analogous to a keyboard "debounce" routine, 
near (A) . Loop, until the hardware recognises a signal, at (B) . This is 
signal is bound to have died away, and reset the hardware latch, at (C) . 
(D) , and listen for another signal, YES, then it's a one, NO, then it's a 
after the sampling time, at (E) , and loop again until the next time (A). 



To read a single bit, start somewhere 
a clock pulse. Now loop until that 
Now wait an exact length of time, till 
zero. In either case reset the latch 



As you can see, the TIMER must not be running during either record or playback, since exact looping times 
are vital. Nor does the logic take time off to test the keyboard for the BREAK key. However tape speed is not 
ultra-critical, since there is a resynchronisation wires at (A) on every bit. 



RECORD} 



Jl 



LI 



n 



Lf 



n 



w-j 



u 



playback; 



-^v 




A 6 



C D 



E & 




nmimmmmmmmmimnnttimm 



'software, 




PO Box 39, Eastleigh, Hants, England. S055WQ 



